home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / sflst101.zip / SFLSTGEN.DOC < prev    next >
Text File  |  1991-10-12  |  14KB  |  327 lines
  1.  
  2. ┌─────────────────────────────────────────────────────────────────────────────┐
  3. │                 ╒═════════════════════════════════════════╕                 │
  4. │  ┌──────────────┤    SF■File List & Bulletin Generator    ├──────────────┐  │
  5. │┌─┼─┐            ╘═════════════════════════════════════════╛            ┌─┼─┐│
  6. ││ └─┘                                                                   └─┘ ││
  7. ││                               Version 1.01                                ││
  8. ││                              Public Release                               ││
  9. ││                                                                           ││
  10. ││                            RelayNet ID:IVYTECH                            ││
  11. ││                                                                           ││
  12. ││                            By: Philip K. Brown                            ││
  13. ││                                                                           ││
  14. ││                          Brown Business Software                          ││
  15. ││                           243 South 24th Street                           ││
  16. ││                        Terre Haute, Indiana  47803                        ││
  17. ││                                                                           ││
  18. ││                                                                           ││
  19. ││                                                                           ││
  20. ││ ┌─┐   Support BBS: Ivy Tech's BBS    (812) 299-9306  RIME ID:IVYTECH  ┌─┐ ││
  21. │└─┼─┘                The Saratoga BBS  (812) 877-9161  US Robotics HST  └─┼─┘│
  22. │  └───────────────────────────────────────────────────────────────────────┘  │
  23. └─────────────────────────────────────────────────────────────────────────────┘
  24.  
  25.  
  26.  
  27.                                   Introduction
  28.  
  29.  This program is created for Spitfire Bulletin Boards Systems so users can
  30.  download a complete listing of all files available on his/her board.   This
  31.  list will be available in 2 formats.  One will be a .ZIP file and the other
  32.  will be an ASCII Text file with a .LST extension.
  33.  
  34.  This program will also take the information used in creating the list to
  35.  create a File Area Statistics bulletin that will display the file area
  36.  description, file area number, directory size and total number of files in
  37.  each file area.  After all file areas are displayed, a total will be
  38.  displayed at the bottom.  This will be in 1 bulletin, With a .CLR (color) and
  39.  .BBS (black and white) placed in the Spitfire Display path.
  40.  
  41.  
  42.                                 Upon Registration
  43.  
  44.  Once you have registered this program,  you will receive a update that will
  45.  enable the following options:
  46.  
  47.    - Disables the nag screen on the opening screen.
  48.    - Display your Bulletin Board Name on the File Area Statistics Bulletin.
  49.    - Display your Bulletin Board Name in the listing that was created.
  50.    - It will use your name instead of 'Unregistered Copy' when running this
  51.      as an event.
  52.      
  53.  
  54.                                     Warranty
  55.  
  56.  
  57.  This product is provided "as is" without warranty of any kind.  The entire
  58.  risk as to the results and performance of the program is assumed by you.
  59.  Further more, I, the author, do not warranty, guarantee, or make any
  60.  representations regarding the use of, or the results of the use of the
  61.  program, and you rely on the program and results solely at your own risk.  I,
  62.  the author, cannot accept responsibility for system damage, loss of profit, or any
  63.  other special, incidental, or consequential damages resulting from the use or
  64.  inability to use this product.
  65.  
  66.  
  67.                                     Copyright
  68.  
  69.  
  70.  File List & Bulletin Generator is to be distributed as SHAREWARE.
  71.  Under this concept you may use the SHAREWARE (unregistered) version for a
  72.  reasonable period of time, which I consider to be four weeks, after which you
  73.  must either register your copy or discontinue usage.
  74.  
  75.  
  76.  
  77.  
  78.  
  79.                                   Distribution
  80.  
  81.  You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  82.  version of File List & Bulletin Generator provided that all files contained in the original File List archive are distributed in their
  83.  original, unmodified state.
  84.  
  85.  
  86.  The following files are required for the File List & Bulletin Generator:
  87.  
  88.    - SFLSTGEN.EXE     Executable Program
  89.    - SFLSTGEN.OVL     Overlay File for SFLSTGEN.EXE
  90.    - SFLSTGEN.DOC     Documentation (Currently Reading it)
  91.    - AREA2TXT.EXE     Collects Spitfire File Area Information
  92.                            (Called From SFLSTGEN.EXE)
  93.  
  94.  The following file(s) are created the first time you run SFLSTGEN SETUP:
  95.  
  96.    - SFLSTGEN.000     Data File - Information needed by SFLSTGEN.EXE
  97.    - SFLSTGEN.001     Data File - Used when reading SFFILES.BBS
  98.    - SFLSTGEN.002     Data File - Used in Creating Bulletin
  99.    - SFLSTGEN.003     Data File - File Area Information
  100.  
  101.  The following file(s) are created & deleted during the execution of the
  102.  program.  NOTE: You never see the files listed below unless their is an error.
  103.  
  104.    - SFLSTGEN.PTH     Data File - Used in collecting File Area Information
  105.    - SFLSTGEN.DSK     Disk File - Used in saving memory to disk before
  106.                                   dropping to dos to perform the PKZIP or
  107.                                   reading SFFAREA.DAT.  When the 2 tasks are
  108.                                   completed memory is restored.
  109.  
  110.  The following file is created if a 'Disk Full' Error is encountered:
  111.  
  112.    - ERROR.LOG        This LOG file reports any 'Disk Full' Errors.
  113.  
  114.  
  115.              ----- Features of File List & Bulletin Generator -----
  116.  
  117.   -  Runs on Spitfire Bulletin Boards Version 2.8 to 3.xx!
  118.   -  Need Help?  Type SFLSTGEN HELP and a brief help window is displayed.
  119.   -  Ease of Configuring!  Type SFLSTGEN SETUP and follow the prompts..
  120.   -  Creates both .BBS & .CLR Bulletins.
  121.   -  Lets you pick what Directory you want to put your Lists in.
  122.   -  Lets you pick what file areas you want to add to the list.
  123.   -  CD-ROM Support.
  124.   -  Works well in a multi-node environment.
  125.  
  126.  
  127.                        ****** Setting Up File List ******
  128.  
  129.  You will need to create a directory you wish to run this program from.  I
  130.  suggest C:\SF\SFLSTGEN or something similar, after it's created, then change
  131.  to that directory, and then unzip the SFLST101.ZIP into that directory.
  132.  
  133.  When thats done, you must type SFLSTGEN SETUP then it will display a screen
  134.  with some options for you to fill in.  If you make a mistake, just use you
  135.  arrow keys to move to the line and make the correction.
  136.  
  137.  The first line is for your Bulletin Board name.  This is only available upon
  138.  your registration.
  139.  
  140.  When you have filled in all the blanks, just press enter and it will ask you
  141.  if the above information is correct.  If not, then please press "N" and make
  142.  the appropriate changes.  When the above information is correct answer "Y"
  143.  the next question it will ask is "Have you made any changes in the File Area
  144.  Section.".  Please answer "Y" to this question.
  145.  This will allow you to select the File Areas you want to include in this
  146.  Complete File Listing.
  147.  
  148.  Using the "" (Up) and "" (Down) keys, you can browse thru the File Areas.
  149.  If you see a File Area you don't want to include in the list, press the
  150.  Spacebar; it will put "Don't Use" in a box on the line above.  If you decide
  151.  you want that File Area then press the Spacebar again to unselect it.
  152.  
  153.  When you come to the area you want your Zip and Text file to be placed, press
  154.  the Insert Key and "Put Zip Here" is placed in the second box on your screen.
  155.  If you make a mistake press the Insert key a second time to remove your
  156.  selection.  Remember, this list can only go to one File Area.  Please make
  157.  sure you select the right area.
  158.  
  159.  If you have a CD-ROM setup on your board then as you are browsing thru the
  160.  file areas and one is a CD-ROM area then the words "CD-ROM" will appear in the
  161.  third box on the line above.
  162.  
  163.  This is done automatically for you.  All CD-ROM areas will check the DISPLAY
  164.  directory for the individual SFFILES.<File Area Number>.
  165.  
  166.  When you have selected everything you need, press enter <Enter> or Return to
  167.  save your corrections.  This will return you to the DOS prompt.
  168.  
  169.  The next step is setting up an Event for this program to run under.
  170.  
  171.  Using your favorite Text Editor, you will need to edit SF.BAT in your
  172.  Spitfire System directory usually C:\SF.
  173.  
  174.  Listed below are 2 examples you can use to create your event:
  175.  
  176.  NOTE: The following examples assume your Spitfire directory is C:\SF and you
  177.        have placed the files in a directory called SFLSTGEN off of your C:\SF
  178.        directory. ie.  C:\SF\SFLSTGEN
  179.  
  180.        If your system does not support ANSI color graphics then use the
  181.        following line when running this event.
  182.  
  183.                Replace "SFLSTGEN COLOR" with "SFLSTGEN MONO"
  184.  
  185.  --- Sample Batch File For Normal Setup ---
  186.  
  187. :EVENT_K
  188.    REM  Spitfire's SF■File List & Bulletin Generator
  189.    CD C:\SF\SFLSTGEN
  190.    SFLSTGEN COLOR
  191.    CD C:\SF
  192.    GOTO LOOP
  193.  
  194.  --- Sample Batch File For Multi-Node ---
  195.  
  196.  If yours is a multi-node board, use the following commands.
  197.  (SFBUSY.COM is shareware available from Buffalo Creek Software.)
  198.  This usage has been tested on multi-node Spitfire board.
  199.  
  200. :EVENT_K
  201.    REM  Spitfire's SF■File List & Bulletin Generator
  202.    CD C:\SF\SFLSTGEN
  203.    SFBUSY C:\SF\WORK /S
  204.    IF ERRORLEVEL 2 GOTO EVENT_K
  205.    IF ERRORLEVEL 1 GOTO K_END
  206.    SFLSTGEN COLOR
  207.    SFBUSY C:\SF\WORK /C
  208. :K_END
  209.    CD C:\SF
  210.    GOTO LOOP
  211.  
  212.  After you have added the Event to SF.BAT you must Enable the Event within
  213.  Spitfire.   Please refer to the Spitfire Manual for assistance.
  214.  
  215.  
  216.  NOTE: If this program has a Disk Full Error then a ERROR.LOG is created
  217.        and pauses a moment on the screen and then returns to DOS or to your
  218.        next event.
  219.        This program has not been tested on Networking (Lan environment).
  220.        This program may not work Dropped to DOS via Spitfire!  Insufficient
  221.        memory.
  222.        Please make sure PKZIP is in your DOS path.
  223.  
  224.  ====== Support == Support == Support == Support == Support == Support =======
  225.  
  226. If you have any problems, find any bugs, just have an idea; please feel free
  227. to contact me.  Listed below are a two ways to do so.
  228.  
  229.    Call the following Bulletin Boards:
  230.  
  231.        Ivy Tech's BBS        (812) 299-9306  19200/9600/2400/1200 Baud
  232.        The Saratoga BBS      (812) 877-9161  19200/9600/2400/1200 Baud
  233.  
  234.    If you are a member of RIME, you can leave me a message in any of
  235.    the Spitfire Conferences, or in the COMMON Conference and you can route
  236.    the message to me at Ivy Tech's BBS by placing a ->IVYTECH   on the
  237.    first line of the message and sending it to Philip Brown.
  238.  
  239.    If you are a Registered Sysop, all new updates will be available to you.
  240.    However, you must Download them or pay for postage, but I will mail the
  241.    first Registered Copy to you.
  242.  
  243.  ====== Support == Support == Support == Support == Support == Support =======
  244.  
  245.  
  246.  
  247.  
  248.                          Something That Needs To Be Said
  249.  
  250.  I would like to thank Richard Heckelsberg for the help and ideas he gave me
  251.  while writing this program and for standing by me while I used his Bulletin
  252.  Board for testing.   Not many people would allow you to do that.
  253.  
  254.  I would like to thank my Dad, Donald Brown for his help in general and
  255.  starting a Computer Consulting Company.  Brown Business Software.
  256.  
  257.  I would like to thank Mike Woltz for creating Spitfire Bulletin Board
  258.  Software.  Without it this program would not have been.
  259.  
  260.  This program is written using Clipper, a dBASE Compiler.  Many thanks to
  261.  Doug Stevens and Larry Taylor, two instructors who taught dbase II and
  262.  Advanced dBASE III+.
  263.  
  264.  
  265.                   Copyright, Trademark and Service Mark Notices
  266.  
  267.  CLIPPER is a trademark of Nantucket Corporation
  268.  
  269.  NANTUCKET is a registered trademark of Nantucket Corporation
  270.  
  271.  SPITFIRE is Copyright (c) 1987-1991 by Mike Woltz
  272.  
  273.  SPITFIRE is a registered trademark of Buffalo Creek Software.
  274.  
  275.  PKZIP is a Copyright (c) 1989-1990 PKWARE Inc.  All Rights Reserved.
  276.  
  277.  SWAP is a Copyright (c) 1988-1991 by Berner & Associates.
  278.  
  279.  
  280.  
  281.                             ***** Registration *****
  282.  
  283.  
  284. Mail to:   Brown Business Software
  285.            c/o  Philip K. Brown
  286.            243 South 24th Street
  287.            Terre Haute, Indiana  47803
  288.  
  289.  
  290.       Your Name______________________________________________________
  291.  
  292.  Street Address______________________________________________________
  293.  
  294.            City______________________________________________________
  295.  
  296.      State, Zip______________________________________________________
  297.  
  298.     Home Phone#______________________________________________________
  299.  
  300.  
  301.   BBS Name___________________________________________________________
  302.  
  303.   BBS Hours____________________ /Baud Rate___________________________
  304.  
  305.   BBS Phone#_________________________________________________________
  306.  
  307.   BBS Software_______________________________________________________
  308.  
  309.   Are you a Member of RIME?_________  If Yes, What is you ID:________
  310.  
  311.  
  312.   Disk Format (Check one)    5 1/4 (360k) _____    3 1/2 (720k) _____
  313.  
  314.  
  315.  Please send a Bank draft/money order or Postal Money order for $15.00 to
  316.  the address on the top of this form.  If you must send a Personal check,
  317.  this will cause a 2-3 week delay in processing.  THANK YOU for registering.
  318.  It will encourage me to write more Programs in the future.
  319.  
  320.  
  321.  
  322.           Ivy Tech's BBS                     The Saratoga BBS
  323.         Philip Brown, SysOp               Rick Heckelsberg, SysOp
  324.           (812) 299-9306                 (812) 877-9161 - 2 Node's
  325.       19200/9600/2400/1200 Baud          19200/9600/2400/1200 Baud
  326.  
  327.